home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / dman_300.zip / DOOREDIT.DOC < prev    next >
Text File  |  1992-11-15  |  12KB  |  232 lines
  1.  
  2.                            DoorMan Menu Editor v3.00
  3.                                  Documentation
  4.  
  5.                     ┌───────────────────────────────────┐
  6.                     │                                   │
  7.                     │      !! DESQView Users !!!        │
  8.                     │                                   │
  9.                     │ This program uses direct screen   │
  10.                     │ writes!  Make sure to tell DV     │
  11.                     │ when you set up a window for it.  │
  12.                     │ Under DV 2.41, the program will   │
  13.                     │ run fine in a 256k window.        │
  14.                     │                                   │
  15.                     │ If you're running Wildcat, DO     │
  16.                     │ NOT attempt to shell from Wildcat │
  17.                     │ to this program!  It WILL cause   │
  18.                     │ problems.  Simply open another    │
  19.                     │ window for it.                    │
  20.                     │                                   │
  21.                     └───────────────────────────────────┘
  22.  
  23. OVERVIEW
  24.  
  25. DoorEdit is a companion program for DoorMan.  This is the utility used to
  26. create and edit the "catalog" of doors available on your system and to
  27. add/update all information the Door may need.  The doors are divided into
  28. categories to make them easier to find.  DoorMan is limited to 15 categories
  29. with 15 doors in each for a grand total of 225 doors.  If you want to run
  30. more than 225, get in touch with me and I'll see what I can do about upping
  31. the limit!  The first time you run the program, you will be prompted to fill
  32. some questions.  These are to find out about your system, and to set up
  33. the defaults for everything in the program.  You should attempt to answer
  34. every question.  If you're not sure what to answer, simply hit F2 and context
  35. sensitive help will pop up.  You'll only have to do this one time!  You can
  36. go back and change the information later, but you need to get as much of
  37. it as possible the first time through.  The single most important question
  38. in there is the number of nodes your BBS has.  This will determine how many
  39. nodes the program will prompt you to enter information for.  If you don't
  40. get the info in there for all the nodes, DoorMan will not be able to use
  41. them.  There are a few things that can be left blank, for instance, any 
  42. time it asks you for a screen name, you can leave it blank, same goes for
  43. messages.  You can change them later if you like.  Once you've completed 
  44. the list of question, the program will create a file called DoorMan.Def.
  45.  
  46.  
  47. OPERATION
  48.  
  49. Starting with this version, just about every single prompt in the program
  50. has context sensitive help available.  Therefore, the docs aren't going
  51. to be as in-depth as before.  If you're unsure what to do, hit F2!!
  52.  
  53.  
  54. CATEGORIES
  55.  
  56. A category is defined by a name, four character abbreviation, a security
  57. level, Hide Flag, and a Menu Style.  When you tell the program to add a
  58. category, which you must do before you add any doors, you will be
  59. presented with a data input screen.  On this screen, you will fill out
  60. everything about this category.  You will also notice that the defaults
  61. you defined in the initial setup will automatically come up.  Following
  62. is a brief explanation of each item:
  63.  
  64.   Name:  This is what will be displayed in the Main Menu of the door.
  65.  
  66.   Abbr:  This abbreviation is used to reference the category internally.
  67.  
  68.   SecLv:  This is the minimum security level to access this category.
  69.           User's who have this security level or higher will have
  70.           access.
  71.  
  72.   Hide:  If set to Yes, user's who do not have access to the category
  73.          will not even see it!  If set to No, user's who do not have
  74.          access will be shown the name with a red X at the end.  If
  75.          they attempt to choose it, the will be told that their 
  76.          security level does not allow access to this item.
  77.  
  78.   Menu Style:  When you come to this item, you will be presented with
  79.                a list of the available styles.  Simply point the 
  80.                cursor at one and hit enter.  If you choose Random,
  81.                each time the menu is displayed DoorMan will choose one
  82.                of the menu styles.  If you want to take a peek at
  83.                them, simply choose Show Styles.
  84.  
  85.  
  86. To edit a category, you simply choose one from the list, and the same
  87. screen will pop up with that categories information in it.  To delete
  88. one, you simply choose it from the list.  To delete a category, you must
  89. first delete all the doors in the category, safety precaution!
  90.  
  91.  
  92. DOORS
  93.  
  94. When you go to add a door, you must first tell the program which category
  95. the door goes in.  After that, each door in your menus is defined using the
  96. following items:
  97.  
  98.      Door Name:  This is the name as you want it to appear in the menu.
  99.                  Can be anything you like.
  100.  
  101.      Abbreviation:  This is the four character "code" which is written to
  102.                     the DoorMan.Dat file each time the door is used.
  103.  
  104.      Description:  This will also appear in the menu.  Can be anything.
  105.  
  106.      Sponsor:  This was added due to the fact that all the doors on my
  107.                system have been sponsored.  For sponsoring a door, I 
  108.                promised my users that they would get recognition.  Before
  109.                DoorMan, I had an intro bulletin for each door.  Now, I
  110.                Have this.  If you put anything here, it will be displayed
  111.                each time a user enters this door in a message like this:
  112.  
  113.                   This door was sponsored by <<Whatever you put here>>
  114.  
  115.                What I do on my board for "unregistered" doors is put:
  116.  
  117.                   -=> Your Name Could Be Here <=-  Cost $20
  118.  
  119.                Of course the $20 is adjusted to whatever the door costs
  120.                to register.  You'd be surprised how many users will send
  121.                the money to get their name displayed!!
  122.  
  123.      
  124.      Security Level:  This is the minimum SL required to enter the door.
  125.                       If a user has a SL equal to or greater than this,
  126.                       then they will have access to the door.  If this is
  127.                       set to 0, then all users will have access. 
  128.  
  129.      Nodes:  This tells DoorMan which nodes can use a door.  When you 
  130.              come to this field, you will be presented with a list of
  131.              nodes.  Ever how many you have told DoorMan you have. Simply
  132.              choose which nodes have access to this door by tagging them
  133.              with the spacebar.  When you're done, hit D.  When a user
  134.              logs on to a Node that does not have access to this door,
  135.              the door will not even show up in the menu! 
  136.  
  137.      Check Use:  This tells DoorMan whether or not to allow two users
  138.                  in the door at the same time.  If this is set to No,
  139.                  then DoorMan does no checking to see if the door is
  140.                  in use! If set to Yes, then it looks for a "use" file
  141.                  which is created when someone enters a door.  If it
  142.                  finds one, it will read it and tell the user attempting
  143.                  access:
  144.  
  145.                  Sorry!  <UserName> is using <Door Name> on node #.
  146.  
  147.      Registered:  If this option is turned on in the config file, DoorMan
  148.                   will look here for a Yes.  If it finds one, it will put
  149.                   a green * beside the door's description in the menus.
  150.  
  151.      Hide:  This decides whether or not the door should be shown to users
  152.             who do not have access.  If set to No, the door will show
  153.             up in the menu, but have a red X at the end.
  154.  
  155.      9600+:  If set to Yes, DoorMan will only allow users who are
  156.              connected at a baud rate of 9600 or greater to enter the
  157.              door.  This defaults to hidden.  Bear in mind, DoorMan 
  158.              has no way of actually telling what baud rate the user is
  159.              connected at!  It simply reads this information from the
  160.              caller info file.  Therefore, if your BBS software writes
  161.              the Locked baud rate to the file (as opposed to the connect
  162.              rate) this feature will not function properly!
  163.  
  164.      Locked:  If set to Yes, DoorMan will allow NO ONE in the door!
  165.               This is designed to be used when you are not using a
  166.               door but want to keep it in the menu.
  167.  
  168.      Sysop Stats:  If No, your door usage for this door will not be
  169.                    recorded in the log files, bulletins, or graphs.
  170.  
  171.      Max Time:  When a user chooses a door, DoorMan will look at this
  172.                 value, compare it to the user's time left, and pass
  173.                 the lesser of the two to the door.  That is, if this
  174.                 is a non 0 value.  If it is set to 0 (or blank), DoorMan
  175.                 will pass the user's time left to the door.
  176.  
  177.      Opening Screen:  This is a place to insert a screen of your choice
  178.                       before this door loads.  It defaults to extensions
  179.                       of ANS for ANSI and ASC for non-ANSI.  If you put
  180.                       a name in here, DoorMan will look in the directory
  181.                       you have defined for Opening Screens for the 
  182.                       proper screen.  If it finds the file, it will 
  183.                       display it to the user and wait for a keypress.
  184.                       At present, these screens are not abortable!  If
  185.  
  186.                       the screen you put in is more than 24 lines long,
  187.                       DoorMan will insert Pauses where needed.
  188.  
  189.     Scores Files:  This is the name and extension of the scores files
  190.                    for this door.  When a user hits "S" from the menu
  191.                    with the cursor pointed at this door, DoorMan will
  192.                    first look in the directory you've defined for
  193.                    Scores, then in the door's directory for the correct
  194.                    file.  If it finds the file, it will be displayed.
  195.  
  196.     Door's Dir:  This is the actual path name to the Door.  This is
  197.                  what DoorMan will use when creating the bat file to
  198.                  run this door.  In other words, it will change dir
  199.                  to here then issue the commands to run the door.  This
  200.                  is also the directory where DoorMan will look for the
  201.                  scores files.
  202.  
  203.     Caller Info File:  This is the file that the door requires.  When
  204.                        you come to this field, you will be presented
  205.                        with a list of available files.  Simply choose
  206.                        one with the spacebar and hit D for Done.  When
  207.                        DoorMan runs this door, it will read whatever
  208.                        file you have called it with and write whatever
  209.                        file you put here.  The file will be created
  210.                        in the "Caller Info File Path" for the current
  211.                        node.  At the present time, DoorMan does not
  212.                        delete the files when the user returns.  This
  213.                        is primarily for testing purposes and may be
  214.                        changed in the future.
  215.  
  216.     Run Commands:  These are the actual commands to run the door.  There
  217.                    should be no reason for putting change directory
  218.                    commands in here!  In fact, if you do put them in
  219.                    here, DoorMan will most likely freak out!  On most
  220.                    doors, this will simply be the name of the EXE file
  221.                    and the name of the config file.  If you need to
  222.                    insert a node specific command, there are a number
  223.                    of symbols which will be replace when the door runs.
  224.                    Hit F2 for a list of these symbols from within the
  225.                    Run Command Editor.   
  226.                   
  227. That's it.  Once you've entered all these, the program will know how to
  228. handle the door.
  229.  
  230. NOTE: On the Caller Info File, and Nodes fields, you
  231.       must hit Enter to either get a pick list.
  232.